Release 10.1A: OpenEdge Development:
Progress Dynamics Web Development Guide

Configuring the IIS Web server

These configuration instructions apply to the Microsoft IIS Web server. Configuration tasks include:

Setting up virtual directories
Setting up extension mapping

Setting up virtual directories

You create a virtual directory for Progress Dynamics static files so that the Web server can find them. (The other alternative is to copy the static files to the Web server’s Document Root directory.) You can think of a virtual directory as an alias for install_dir\tty\dynamics\ry, the directory where the Progress Dynamics install places the static files.

You can use the IIS Web server’s Internet Service Manager to set up virtual directories. The Internet Service Manager can usually be found under the Administrative Tools section of the Windows Control Panel. When it is running, select Default Web Site. Then select Action New Virtual Directories. A wizard takes you through the process of creating a virtual directory.

Setting up extension mapping

You use extension mapping to enable the Web Server to find the Progress Dynamics WebSpeed Broker. (The other alternative is to explicitly name the Broker in the default HTML layout file.)

This section contains instructions on setting up extension mapping for .wsc and .icf on the IIS Web server.

Note: Extension mapping for .wsc (in addition to .icf) is necessary to enable the WebSpeed CGIIP Messenger to run under IIS. For more information, read the cgiip.wsc file. It is located in install_dir\bin, where install_dir is the folder where OpenEdge is installed.

To set up extension mapping:

Start the Web server if it is not already running.
Start the Internet Services Manager.

You can usually find the Internet Services Manager under Administrative Tools in the Windows Control Panel.

Under the Web Sites node, expand the Default Website node.
Right-click on the Scripts folder.

The Scripts folder should be a virtual directory that points the Web server’s scripts directory, usually C:\Inetpub\Scripts. If it does not exist, you can create it. See the "Setting up virtual directories" section.

Select Properties from the drop-down menu.
In the Virtual Directory tab, choose Configuration.
In the App Mappings tab, choose Add.
In the Add/Edit Application Extension Mapping pop-up window, type the following in the Executable field:

install_dir\bin\cgiip.exe %s %s

Where install_dir is the directory where you installed OpenEdge. (If install_dir contains spaces, you must enclose it in quotation marks.)

Type the following in the Extension field:

.wsc

Select the Script Engine check box. Deselect the Check that file exists check box.
Choose OK.
In the App Mappings tab, choose Apply. Then choose the OK button.
Right-click on the virtual directory that was added for Progress Dynamics (for example, dynamics20) under the Default Website node.
Select Properties from the drop-down menu.
In the Documents tab, check the Enable Default Document option. The settings should look similar to the following:



In the Virtual Directory tab, choose Configuration.
In the App Mappings tab, choose Add.
In the Add/Edit Application Extension Mapping pop-up window, type the following in the Executable field:

install_dir\bin\cgiip.exe -i wsdynamics1

Where install_dir is the directory where you installed OpenEdge. (If install_dir contains spaces, you must add quotes around it.) wsdynamics1 is the name of the Progress Dynamics Web Broker.

Type the following in the Extension field:

.icf

Select the Script Engine check box. Deselect the Check that file exists check box.
Choose OK.
In the App Mappings tab, choose Apply, and then choose OK.
Exit from the Internet Service Manager.
Note: If you use extension mapping, only one Progress Dynamics Broker can be set up for the Web server.